COMMAND-LINE INTERFACE SYSTEM AND METHOD 
FOR JAVA MESSAGE SERVICE MARK-UP LANGUAGE 



Inventor; Kathiravan Sengodan 

COPYRIGHT NOTICE 

A portion of the disclosure of this patent document contains material 
which is subject to copyright protection. The copyright owner has no objection 
to the facsimile reproduction by anyone of the patent document or the patent 
disclosure, as it appears in the Patent and Trademark Office patent file or 
records, but otherwise reserves all copyright rights whatsoever. 

Claim of Priority: 

[0001] This application claims the benefit of U.S. Provisional Application No. 
60/442,780, filed January 27, 2003, and is incorporated herein by reference. 

Cross-R ferences: 

[0002] This application is related to co-pending U.S. Utility Patent Application Serial 
No. by Kathiravan Sengodan entitled "SYSTEM AND METHOD FOR JAVA 

MESSAGE SERVICE MARK-UP LANGUAGE", filed (BEAS-01351US1). U.S. 

Utility Patent Application Serial No. by Kathiravan Sengodan entitled 

"WEB-BASED INTERFACE FOR JAVA MESSAGE SERVICE MARK-UP LANGUAGE", 
filed " (BEAS-01351US2). and U.S. Utility Patent Application Serial No. 

by Kathiravan Sengodan entitled "INTEGRATED DEVELOPMENT 
ENVIRONMENT FOR JAVA MESSAGE SERVICE MARK-UP LANGUAGE", filed 

(BEAS-01351US4), which applications are also incorporated herein by 

reference. 

Field of tlie Invention : 

[0003] The invention relates generally to the Java Message Service (JMS) and Java 
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Management Extensions (J MX), and particularly to a command-line interface for using a mark- 
up language to access JMS/JMX interfaces. 

Background : 

[0004] In a business enterprise environment, the JAVA 2 Enterprise Edition (J2EE) 
platform is often used to build distributed transactional applications for the enterprise. To allow 
for rapid application design, the J2EE platform provides a component-based approach to the 
design, developmeint, assembly and deployment of enterprise applications. The J2EE 
platform offers a multi-tiered distributed application model, and the ability to reuse 
components. In a multi-tiered distributed application model, application logic is divided into 
components according to their function. The components are themselves often physically 
divided among separate machines depending on their association to a certain J2EE 
environment tier. Communication for the purpose of coordination between physically and 
logically distinct components of an enterprise application is therefore a complex task. 
[0005] The JAVA Message Service (JMS) API was introduced primarily for the 
purpose of allowing JAVA applications to interact with messaging-orlented middleware 
(MOM) systems such as IBM's MQSeries and Peerlogic's PIPES software. Today, JMS has 
largely replaced such MOM systems and many vendors have adopted and implemented the. 
JMS API. JMS has become increasingly robust and currently offers such features as the 
capability for any application client, Enterprise JAVABean (EJB) or Web component to 
synchronously send and/or receive a JMS message. Application client components can also 
receive JMS messages asynchronously. A unique type of EJB, the message-driven bean, 
extends the capability for asynchronous JMS message consumption to other enterprise 
components. Generally, the JMS API simplifies inter-component communication by enabling 
loosely coupled asynchronous communication across the board between J2EE components 
individually and also between legacy system messaging implementations and J2EE 
components considered collectively. 
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[0006] Frequently, a JMS based application development requires configuring and 
managing certain JMS components on the server side like JMS Connection Factories, JMS 
Destinations etc., as well as designing application clients capable of interacting with the 
server-side components. Application clients utilizing JMS functionality can be categorized as 
producers, consumers, or both. Producer-type application clients are responsible for creating 
various JMS message types (such as text, XML, objects, streams and bytes) and relaying 
them to JMS destinations (such as queues and topics). Consumer-type application clients 
may subsequently receive messages from these destinations in either synchronous or 
asynchronous fashion. 

[0007] Message producers and consumers communicate using either the 
"Point-to-Point" orthe "Publish-Subscribe" messaging model. The chief characteristic of the 
"Point-to-Point" model is a pne-torone relationship between messages sent by message 
producers and message consumers. The JMS API achieves this by using queue destinations. 
A single message may be enqueued by at most one message producer, and may be 
dequeued by at most one consumer. The "Publish-Subscribe" model differs in that a 
one-to-many relationship exists between message producers and consumers. Messages are 
routed through "Topic" destinations. A single message may be published into the topic by, at 
most, one message producer, yet may be retrieved by a plurality of message consumers. 
Most implementations of the JMS API support each of the "Point-to-Point" and the 
"Publish/Subscribe" messaging methodologies, as well as combinations of the two, further 
easing issues of integration with legacy messaging products. 

[0008] The JAVA Management Extensions (JMX) comprise a set of specifications and 
development tools for managing JAVA environments, and for building third-generation 
Operation, Administration and Management/Monitoring (GAM) solutions. It specifies 
management architecture and APIs, as well as basic management services. JMX offers a 
tiered architecture into which managed resources and management applications can be 
integrated in a plug-and-play manner. 
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[0009] The standard JMX architecture is composed of 3 tiers - the instrumentation 
level, the agent level, and the manager level, often referred to as the "distributed services 
level". The instrumentation level typically contains objects of broad interest to developers 
generally. The agent level provides management agents which are containers that provide 
core management services which are capable of being extended by adding other JMX 
resources. Finally, the manager level provides management components that operate as a 
manager or agent for distribution and consolidation of management services. 
[0010] In application servers, such as BEA's WebLogic Server, JMX is extensively 
used for operation, administration and management of application server objects through 
interaction with Management Beans (also referred to as MBeans). WebLogic Server, for 
example, utilitizes "Config MBeans" and "Runtime MBeans" to configure and monitor server 
internals. "Config MBeans" represent the configuration inforrnation of a booted WebLogic 
Server. The application server creates a "Config MBean" for each element of the config.xml 
file and an administrator can modify the configuration of a running application server by simply 
interacting with the identified "Config MBean". A "Runtime MBean" is used for monitoring 
application server performance by maintaining state information on any variety of server 
statistics and an administrator may readily ascertain the desired information by interacting 
with the "Runtime MBean" using the functionality of the JMX API. 
[001 1 ] At a more granular level, the JMS and JMX APIs are themselves very complex, 
and the intricacies of both can be difficult to learn and use. Therefore, utilizing these APIs is 
often a tedious process, and is also sometimes confusing to novice programmers and 
developers. It is not uncommon for a developer to have to write long and complicated code 
to instantiate JMS objects, to facilitate interactions between JMS objects and to manage all 
of these objects and transactions. The computer instructions necessary to build similar but 
slightly different JMS objects and their usage often requires the programmer to rewrite 
essentially the same code multiple times for each object, resulting in wasted resources and 
a decrease in overall efficiency. A method and/or system that could be used for reducing the 
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complexity of this process and for facilitating the Operation, Administration and 
Management/Monitoring and the usage of JMS objects would be of great benefit. 

Summary of the Invention: 

[0012] Generally described, the invention provides a markup language and associated 
tools for JMS (referred to herein as the JMS Markup Language or JMSML). JMSML is useful 
for creating simple arid reusable JMS components for performing all of the JMX operations 
necessary for dynamic configuration, management and runtime monitoring of the JMS server, 
in addition to performing enterprise messaging using the JMS operations. Embodiments of 
the invention include systems and methods that abstract the complexity of the JMS and JMX 
APIs into a relatively small plurality of easy-to-use extensible Markup Language (XML) tags. 
[0013] In accordance with one embodiment, the invention comprises a Java stand 
alone client, acting as the command line interfaceto execute the JMSML program. The user 
can specify the JMSML program name, location along with the server's connection information 
(for example the URL) as command line parameters. This interface then validates these 
parameters and executes the given JMSML program/This interface requires the JMSML 
engine JAR file in the CLASSPATH of the user's execution environment. 

Brief Description of the Drawings: 

[0014] Figure 1 shows a diagram of a system in accordance with an embodiment of 
the invention, and shows the components used by the JMSML engine to process a XML- 
formatted file containing JMSML-compliant tags. 

[001 5] Figure 2 shows a diagram of a JMSML engine as accessible through a plurality 
of "application wrappers" which facilitate user Interaction with the engine, in accordance with 
an embodiment of the invention. 

[0016] Figure 3 depicts the interaction between senders, messages, queues and 
receivers in the Point-to-Point messaging model in accordance with an embodiment of the 
invention. 
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[0017] Figure 4 depicts the interaction between publisliers, messages, topics and 
subscribers in the Publish-Subscribe messaging model in accordance with an embodiment 
of the invention, 

[0018] Figure 5 shows a JMSML system that includes an Integrated Development 
Environment in accordance with an embodiment of the invention. 
[0019] Figure 6 shows the layout and components of an Integrated Development 
Environment may be configured in accordance with an embodiment of the invention. 
[0020] Figure 7 is a screenshot depicting a high level overview of how the JMSML 
Integrated Development Environment may be configured in one embodiment of the invention. 
[0021 ] Figure 8 is a screenshot of the JMSML Integrated Development Environment 
illustrating the JMXdesign screen feature in accordance with an embodiment of the invention. 
[0022] Figure 9 is a screenshot of the JMSML Integrated Development Environment 
illustrating the JMS design screen feature in accordance with an embodiment of the invention. 
[0023] Figure 10 is a screenshot of the JMSML Integrated Development Environment 
illustrating the Messages design screen feature in accordance with an embodiment of the 
invention. 

[0024] Figure 1 1 is a screenshot of the JMSML Integrated Development Environment 
depicting leaves in the JMSML Operation Tree which have corresponding entries in the 
Integrated Development Environment Source Window, and also shows the type of output 
displayed in the Integrated Development Environment Verbose Window after the JMSML 
code residing in the Integrated Development Environment Source Window is executed. 
[0025] Figure 12 is a screenshot of the JMSML Integrated Development Environment 
in accordance with an embodiment of the invention, illustrating the output displayed in the 
Integrated Development Environment Verbose Window afterthe command to create a new 
JMSServer MBean is given. 

[0026] Figure 13 is a diagram of the JMSML Integrated Development Environment in 
accordance with an embodiment of the invention, illustrating the type of output displayed in the 
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Integrated Development Environment Output Window after the JMSML source code displayed 
in the Integrated Development Environment Source Window is executed. 
[0027] Figure 14 is a diagram of the JMSML Integrated Development Environment in 
accordancewith an embodiment of the invention, illustrating the type of output displayed in the 
Integrated Development Environment Output Window after a JMSML command requesting 
the runtime state information on the "Warehouse" queue is executed, in accordance with an 
embodiment of the inyention. 

[0028] Figure 1 5 shows a JMSML system that includes a command-line interface in 
accordance with an embodiment of the invention. 

[0029] Figure 1 6 shows a flowchart of the operation of a JMSML system that includes 
a command-line interface in accordance with an embodiment of the invention. 
[0030] Figure 1 7 shows a JMSML system that includes a web interface in accordance 
with an embodiment of the invention. 

[0031] Figure 18 shows a flowchart of the operation of a JMSML system that includes 
a Web interface in accordance with an embodiment of the invention. 
[0032] Figure 19 shows a screenshot of a Web interface in accordance with an 
embodiment of the invention. 
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Detailed Description: 

[0033] An embodiment of the invention provides a markup language (referred to herein 
as JMSML), and user interfaces, that are useful for creating simple and reusable JMS 
components. The JMS components can be used for performing JMX operations necessary 
for dynamic configuration, management and runtime monitoringof a JMS server, in addition 
to performing enterprise messaging using the JMS operations. JMSML is a mark-up 
language designed and developed to make Java Message Service (JMS) and Java 
Management Extensions (JMX) programming easy by hiding the JMS and JMX Java API 
complexity behind a few easy-to-use XML tags. Embodiments of the invention include 
systems and methods that utilize JMSML to abstract the complexity of the JMS and JMX APIs 
into a relatively small plurality of tags. 

[0034] In accordance with one embodiment, the invention comprises a Java stand 
alone client, acting as the command line interface to execute the JMSML program. The user 
can specify the JMSML program name, location along with the server's connection information 
(for example the URL) as command line parameters. This interface then validates these 
parameters and executes the given JMSML program. This interface requires the JMSML 
engine JAR file in the CLASSPATH of the user's execution environment. 
[0035] A typical JMS application development process involves configuring and 
managing the JMS server components, such as the JMSConnectionFactory, JMSDestination, 
etc., on the JMS Provider application server, and then writing JMS application clients that will 
make use of these administered server-side objects to perform Java messaging. JMS 
application clients are written in Java using the JMS API, and are categorized into two types 
of programs: Producers, and Consumers. Producers create various JMS Message types (like 
Text. XML, Object, Stream, Bytes) and send them to the JMS destinations (Queues and 
Topics). Consumers receive the messages from the JMS destinations (Queues and Topics), 
both synchronously and asynchronously. The JMS API enables both producers and 
consumers to utilize various qualities of service (QOS) that are provided by the underiying 
JMS implementation and by the JMS providers (such as transaction, acknowledgment, etc.). 
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[0036] Creating producers and consumers in tills manner invoives foliowing some 
specific steps, in a specific order, wliile using tlie MS API. This process has to be repeated 
for every single producer and consumer that is written to use Java messaging. Forexampfe, 
in accordance with traditional methods, in order to use the JMS API to send the text message 
"Hello Worid" to a JMS queue named "exampleQueue" using a JMSConnectionFactory 
objectnamed "QueueConnectionFactory" via a non-transacted, auto-acknowledge 
JIVISSession, a JAVA program of such as that shown below may be required: 

import java.util.*; 
import j avax . naming . * ; 
import javax.jms.*; 

piiblic class QueueSend ' 

public final, static String 

JNDI^FACTORY="weblogic. jndi . WLInitialContextFactory"; . 
.public final static String 

JMS_FACTORY="QueueConnectiQnFactory" ; 
public final static String QUEUE =" examp 1 eQueue " ; 

private QueueConnectionFactpry qconFactory; 

private QueueConnection qcon; 

private QueueSession qsession; 

private QueueSender qsender; ' . 

private Queue queue; ' 

private TextMessage msg; 

public void init (Context ctx. String queueName) 
. throws NamingExceptiori, JMSException 

qconFactory = (QueueConnectionFactory) 

ctx . lookup ( JMS_FACTORY) ; 
qcon = qconFactory. createQueueConnection 0 ; 
qsession = qcon. createQueueSession { false , 

S e s s i on . AUTO_ACKNOWLEDGE ) ; 
queue = (QUEUE) ctx . lookup (queueName) ; 
qsender = qsession, createSender (queue) ; 
msg = qsession. createTextMessage 0; . 
qcon. start () ; 

J 

public void send (String message) 

throws JMSException ■ 

{ . ■ 

msg . setText (message) ; " 
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qsender , send(msg) ; 

} 



public void close () 

throws JMSException 

{ 

qsender . close ( ) ; 
qsession . close 0 ; 
qcon. close ( ) ; 

} . . 

public static void main (String [] args) 
throws Exception 

r ' . 

if (args. length != 1) 

{ 

System . out .print In ( "Usage : java QueueSend WebLogicURL'' ) ; 
return; 

} . . . 

InitialContext ic = getlnitialContext (args [0] ) ; 
QueueSend qs = new QueueSendO; 
qs.init{ic, QUEUE); 
qs.sendC'Hello World"); 
qs . close ( ) ; 



} 



private static InitialContext get InitialContext (String url) 
throwsNamingException 

{ ■ 

Hashtable env .= new Ha sht able (); \ . 

env. put (Context . INITIAL_CONTEXT_FACTORY, JNDI_FACTORY) ; 
env. put (Context .PRO VI DER_URL, url); 
return new InitialContext (env) ; 

; -} - 

[0037] As can be seen fronn the above example, using traditional nnethods the required 
Java program is quite long and complex. The JMSML approach to writing JMS application 
clients is accomplished without writing Java code using the JMS API. Instead, the entire JMS 
API complexity is abstracted into a few XML tags that are easy to use and remember. By 
using JMSML, a developer can create simple re-usable JMS components, such as a 
"Sender". "Receiver". "Publisher", and "Subscriber"". JMSML makes administration of a JMS 
server very simple by using XML tags, thus eliminating the JMX Java API complexity. JMSML 
supports all the JMX operations that are needed to do dynamic configuration, management, 
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and runtime monitoring of a JMS server. In accordance with one embodiment, use of the 
present invention significantly simplifies and shortens the length of the required code. As 
illustrated in Figure 1 , an XmL file 20 is formatted with the JMSML-specific tags (described 
in further detail below). This file is then used to perform the necessary operations. An example 
of such an XML file which is analogous in operation to the JAVA code example shown above 
may be represented using JMSML as follows: 

<?xml version="l . 0" encoding="UTF-8 "?.> • ^ 

<!DOCTYPE jmsml PUBLIC "-//BEA Systems Inc//DTD JMSML Version 1.0 
JMSML/ /EN" " jmsml .dtd"> 
<jmsml> 

<operation Class="message" Type="Text-" Name ="MyQueue Sender" 
- ^. Factory="QueueConnect±onFactory" 
Queue ="exampleQueue" 
Body="Hello World" > 
Send . ■ 

</operation> 
</jmsml> 

[0038] In this instance, JMSML will create QueueSender with a non-transacted and 
auto-acknowledge JMSSession. Once this operation is executed, then the "MyQueueSender" 
object is still available for re-use later until the end of the program execution. That is, 
"MyQueueSender" can be re-used to send a different message(s) to a different queue. 

SYSTEM ARCHITECTURE 

[0039] In accordance with one embodiment, JMSML is implemented as a number of 
neatly abstracted Java components grouped together as the extensible JMSML engine., 
which utilizes technologies like JMS, JMX and XML to deliver the power that a JMS 
application developer needs, while hiding all the finer details of Java and JMS API behind a 
fewXMLtiags. 

[0040] Figure 1 shows a logical diagram of a system in accordance with an 
embodiment of the invention, and depicts the steps used by the JMSML engine when 
processing a XML-formatted file containing JMSML-compliant tags. In practice the JMSML 
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engine may run as a process on a computer server or other processing device. The other 
components of the system shown in Figure 1 may operate or exist on the same device or on 
different devices. Some components may operate within the engine itself or may operate as 
different processes communicating with the engine. In one embodiment the engine includes 
the logical components or functionality of an XML parser 22, command processor 24, 
command dispatcher 26, message processor 28, mbean processor 30, system processor 
32, logger 34, and result processor 42. Depending on the implementation not all of these 
components maybe needed. The input JMSML (XML) program is validated and parsed into 
individual command objects that are dispatched to the appropriate command processors. 
MessageProcessor executes all the JMS operations, MBean Processor executes all the JMX 
operations, and System Processor executes all the miscellaneous system commands, like 
SLEEP. The result of the execution is saved in an output file. As shown in Figure 1 , the file 
20 is initially passed to an XML parser 22 which strips out the JMSML-formatted commands 
and sends them on to the command processor 24. The command processor 24 validates the 
snippets of code identified as JMSML commands, parses these bits of code into individual 
command objects, passes the resuitarit command objects to the command dispatcher 26, and 
sends a record of the transaction to the logger module 34. The command dispatcher will 
proceed to group the command objects into one of three categories: JMS command objects; 
JMX command objects; and system command objects. JMS command objects are passed 
to the Message processor module 28, JMX command objects are passed to the MBean 
processor module 30, and system command objects are passed to the System processor 
module 32. Each of these three modules 28, 30, 32 performs the requested operation and 
relays a record of the transaction to the logger module 34. The logger module 34 further 
propagates the execution record into a complete ".out" log file written from standard out 38, 
a ".verbose" log file suitable for debugging purposes 36, and a ".bmk" file suitable for 
benchmarking purposes 40. Finally, the result processor module 42 accepts data from both 
the ".bmk" benchmark file 40 and the standard output (".out") exhaustive log file 38, interprets 
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this data according to the particular implementation, and returns a transmission to the JMSML 
user indicating the success or failure of the operation. 

[0041] Figure 2 illustrates that this method might also be imbedded within an 
"application shell" 50 which facilitates user interaction with the JMSML engine 52. 
[0042] A few of the XML elements currently understood in the JMSML include those 
shown below. It will be evident that additional JMSML elements can be used and understood 
by the engine, depending on the particular implementation: 

< j msml X / j msml > 

<scenario></scenario> - 

<operation></operation> - 
< repeat >< /repeat > 

[0043] Atypical structure ofa JMSML program is shown below. Itwill be evident that 
each JMSML program need not adhere exactly to this structure: 

<jmsml> 

<operation></operation> 

<repeat> , . ■ 

<operation></operation> 

</repeat> 

<scenario> 

<purpose >< /purpose > 

<expectedresult>< /expect edresult> 

<operation></operation> 

<operation></operation> .' 
<repeat> 

<operat ionx/operat ion> 
</repeat> 

</scenario> - . 

</jmsml> . . . 

< j msml ></ j msml > 

<operation></operation> 

[0044] The root element of the JMSML program is the <operation></operation> 
element. This element enables you to define, any of the supported JMSML operations. 
Currently there are four categories of operations supporte^d by JMSML, which provide for(1) 
JMS operations; (2) JMX operations; (3) WebLogic Server (or other server-specific) 

-13- 

Attorney Docket No.: BEAS-01 351 US3 

kfk/beas/1351/1351us3/1351us3.app.wpd Express Mail No. EV 327 616 845 US. 



operations; and (4) SYSTEM operations. Table 1 sliown below summarizes tliese 
operations. It will be evident that additional JMSML operations can be used depending on the 
particular implementation. 



operation 


Name 


Description 


Object Type 


Category 








JMS 


Send 


Send message to a Queue 


JMS Message 




Receive 


Receive message from a Queue 


JMS Message 




Publish 


Publish a message to a Topic 


JMS Message 




Subscribe 


Subscribe to message on a Topic 


JMS Message 




Unsubscribe 


Unsubscribe an existing Topic subscription 


Subscriber 




Recover 


Recover a JIVISSession used by a given consumer 


JMS Session 




Browse 


Browse a Queue for messages 


JMS Queue 




Drain 


Empty a given JMSServer or a Destination 


JMSServer JMSDestination 




Remove 


Delete existing producers and consumers 


SenderPublisherReceiverSubscrib 
er((a)sync) 


JMX 


Add 


Create a JMS configuration MBean with the given 
attribute values and add it to the server 


JMS Mbean 




Change 


Change the given attributes of an existing JMS 
Configuration Mbean 


JMS Mbean 
JMS Mbean 




List 


List all the attributes and their values of a given JMS 






Rennove 


Configuration/Runtime MBean 

Delete an existing JMS Configuration MBean 


JMS Mbean 




Verify 


Verify a Configuration attribute or Runtime Attribute value 
against the given logical expression 


JMS MBean (Configuration and 
Runtime) 




Pause 


Pause a running JMS destination (this is NOOP, if called 
more than once) 


JMSDestination Runtime MBean 




Resume 


Resume a paused JMS destination (this is NOOP, if caljed 
more than once or on a non-paused JMS destination) 


JMSDestination Runtime MBean 




Start 


Deploy (Target) a JMSServer MBean to WebLogic Server 


JMSServer Runtime MBean 




Stop 


Undeploy (Untarget) a JMSServer from a WebLogic 
Server 


JMSServer Runtime MBean 
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WebLogic 


Migrate 


Migrate the JMS/JTA services from one instance of a 


WebLogic Server Mbean 


Server 




WebLogic Server tp another instance in a cluster 






Startup 


Start (boot) a WebLogic Server instance through the 
Admin server using NodeManager 


WebLogic Server Mbean 




Shutdown 


Shutdown a WebLogic Server instance through the 
Admin server using NodeManager 


WebLogic Server Mbean 




Add 


Create WebLogic Log Notification Filters and Listeners to 
receive WebLogic Server/Domain Log notifications for 
any given Subsystems 


WebLogic Log Notification 
FilterWebLogIc Log Notification 
Listener 




1 xCI 1 IWVC 


Delete the existing Log Notification Filters and Listeners 


WebLogic Log Notification 
FilterWebLogic Log Notification 
Listener 


JMSML 


Sleep 


Makes the JMSML engine sleep for the specified amount 


JMSML engine 


SYSTEM 




time during the execution process 






Echo 


Prints out the user specified string to the output file with 
Timestamp 


JMSML engine 



Table 1 



[0045] Each of the operation elements include three required attributes that identify the 
operation Class, Type and Name of the object involved in the operation, as described in 
Table 2 below: 



Attribute Name 


Type 


Required 


Valid Values 


Default 


Class 


String 


Yes 


"ihessage" |"mbean" psystem" 




Type 


String 


Yes 


Valid JMS/iMX objects 




Name 


String 


Yes 


Java String 





Table2 
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<scenario></scenario> 

[0046] The <scenario></scenario> element is used to define a scenario by grouping 
naultiple JMSML operations. This element only has three attributes, as listed in Table 3 below: 



Attribute Name 


Type 


Required 


Valid values 


Default 


Name 


string 


No, 


Java string 


nil 


Verify 


Boolean 


Yes 


"true" 1 "false" 


"false" ■ 


SortedVerification 


Boolean 


No 


"true" 1 "false" 


"false" 


Persistence 


Boolean 


No 


"true" 1 "false" 


"false" 



Table 3 

[0047] The following example shows a JMS client scenario definition using JMSML: 

< scenario Name="order_subTnission_test_l" 
VerifY="false" 
. Persistence="true"> 



<purpose></purpose> 

[0048] The <purpose></purpose> element is a Text element that is used to define a 
purpose for a scenario. It has no attributes. 

<exp ctedresult></expectedre$ult> 

[0049] The <expectedresult></expectedresult> element is a Text elemerit that is used 
to define the expected result of a scenario. It has no attributes. 

<repeat></repeat> 

[0050] The <repeat></repeat> element is an element which defines a repeat countfor 
any given JMLS operation and/or scenario. It has only one attribute named "Count", which 
takes an integer value for the number of iterations. 
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JMSML FEATURES 

[0051 ] JMSML supports both "Point-to-Poinf and "Publish-Subiscribe" models, shown 
in Figure 3 and Figure 4 respectively. The Point-to-Point way of messaging is a 
communication paradigm where a one-to-one relationship exists between the message 
producers and the message consumers. This is achieved in JMS by using Queue 
destinations, as illustrated in Figure 3. The Publish-Subscribe way of messaging is a 
communication paradigm where a one-to-many relationship exists between the message 
producers and the message consumers. This is achieved in JMS by using Topic destinations, 
as illustrated in Figure 4. In addition to the JMS messaging operations, JMSML also 
provides for other useful operations, such as JMS Session recovery, JMS Queue Browsing, 
and Emptying a JMSServer or a JMS Destination. JMSML also includes support for the 
different Quality of Service (QOS) provided by, for example, the WebLogic JMS 
implementation for messaging, such as Transactions (both JTA and Transacted JMS 
Session), Persistence, acknowledgment, etc. 

JMS OPERATIONS 

[0052] Each of the JMS operations need only two required attributes to perform both 
"Point-to-Point" and "Publish-Subscribe": the JNDI names of the factory, and the queue (or 
topic). At the same time, all of the possible JMS API parameters are also available to the user 
and are mapped as operation element attributes. These attributes can be specified as a plain 
string, name-value pair. The JMSML processors will internally convert these values into 
appropriate JAVA data types required bythe JMS API. Table 4 lists the operations defined 
for JMS: 
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Operation 


Function 


Send 


Sends message to a queue 


Receive 


Receives message from a queue 


Publish 


Publishes a message to a topic 


Subscribe 


Subscribes a topic 


Unsubscribe 


Unsubscribe a topic 


Recover 


Recovers a given sender's JMSSession 


Browse 


Browses messages in a queue 


Drain 


Drains all the messages from a JMSServer or a destination 


Remove 


Removes the J MS objects 



Table 4 

Point-to-Point (PTP) Messaging Using MSML 

[0053] The following operations illustrate how JMSML can be used to send messages 
using a point-to-point (PTP) paradigm, in accordance with one embodiment of the invention . 
It will be evident that the invention is not limited to the operations and examples described 
below, which are presented to illustrate the functionality, features, and operation of JMSML. 

Send 

[0054] A "Send" operation is used to create a PTP message producer (or queue 
senders) and then use the newly created message producer to send messages to a queue 
destination indicated by queues 76,78. Message receivers, also known as message 
consumers receive messages from queue destinations. As shown in Figure 3, any single 
message 68, 70, 72, 74 may not be sent by more than one queue sendier 60, 62, 64, 66, nor 
may it be received by more than one consumer 80, 82. If the operation is successful, then no 
message is logged to the output unless the "verbose" option is turned on. If the operation was 
not successful, then appropriate error messages will be logged as output. In one example, a 
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JMS message producer narried "QueueSender" can be created to send a JMS text message 
containing the string "Some Text" to the queue destination which is identified by the "Queue" 
attribute, using the JIVIS connection factory identified by the "Factory" attribute. The following 
example illustrates the syntax of a simple JMSML queue send operation with minimal 
attributes: 

<pperation Class-"message" Type="Text" 
Name= "QueueSender" 

Factory=" JNDI Name of the Connect ionFactory" 
Queue="JNDI Name of .the Queue Destination" 
Body="Some Text" 
>Send</operation> 

[0055] In the example shown below, the operation creates a sender object that 
generates and sends ten (1 0) text messages, each with "Hello Worid" as its content, to the 
queue "MyQueue". The operation uses the connection factory "MyConnectionFactory" within 
a JMS transacted, auto-acknowledged session, and commits the transaction. This send 
operation may be performed with QoS. 

<operation Class= "message" Type="Text" . 
Name = " My S ende r " 

Factory= "MyConnectionFactory" 
Queue = "MyQueue" ■ • . 

Transact ionType= " JMS " 
Transact ion= " cpmmi t " 
Count = '» 10" 
Body= "Hello World" 
>Send</ operation> 

[0056] In the example below, the operation creates a sender and then tries to send 
eleven (1 1 ) text messages, each with "Hello World" as its content, to the queue "MyQueue" 
using the connection factory "MyConnectionFactory" within a JMS transacted, 
auto-acknowledged session, commits the transaction, and expects the 
"ResourceAllocationException" exception when the message quota on the destination 
"MyQueue" is set to "10". These messages may be sent with the ability to handle exceptions. 
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<operation Class="message" Type="Text" 
Name = " My S ende r " 
Factory="MyConnectionFactory" 
Queue = "MyQueue " 

Expect edExcept ion= " Re sour ceAl locat ionExcept ion " 
TransactionType=" JMS" 
Transact ion= " commit " 
Count="ll" Size="128" 
>Send</operation> 

Receive 

[00571 The "Receive" operation is used to create PTP message consumers (or queue 
receivers) that receive messages from a queue destination. If the operation is successful, then 
the content of the message will be logged as output, in addition to any explicit "Print" attribute 
values that are mentioned. If the operation was not successful, then appropriate messages 
will be logged as output. 

[0058] In the example shown below, an Asynchronous (non-blocking) JMS message 
consumer named "QueueReceiver" is created to receive JMS text messages from the queue 
destination, which is identified by the "Queue" attribute using the JMS connection factory 
identified by the "Factory" attribute, and explicitly setting the "Mode" attribute to create an 
asynchronous queue receiver. This simple queue receive operation may be performed as 
follows: 

<operation Class="message" Type="Text" 
Name= "QueueReceiver" 
Mode = "Asynchronous " 

Factory=" JNDI Name of the Connect ionFactory" 
Queue="JNDI Name of the Queue Destination" 
>Receive</operation> 

[0059] In another example below, a synchronous (blocking) queue receiver receives 
ten (10) text messages from queue "Q1 " using the connection factory "QCF1" within a user 
(JTA) transaction for the matching correlation ID selector, with an auto-acknowledged session, 
and rolls back the transaction. The operation blocks for 1 second between each message 
receive and prints the JMS properties message ID and priority as part of the output. A 
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message receive operation within a JTA transaction, using a selector, may be performed as 
follows: 

<operation Cl'ass = "message" Type="Text" 
Name = " My Re ce i ve r " 

Factory^" jms .qa . connect ion. QCFl" 

Queue=" jms .qa. destination. Ql" 
TransactionType="User" 
Transact ion= " rol Iback " 
Count="ip" 
Wait="l" 

Selector="JMSCorrelationID like ^hello'" 
Print=" JMSMessagelD" 
Print="JMSPriority" 
>Receive</operation> 

Publish-Subscribe (PubSub) Messaging Using JMSML 

[0060] The following operations illustrate how JMSML can be used to send messages 
using a Publish-Subscribe (PubSub) paradigm, in accordance with one embodiment of the 
invention. It will be evident that the invention is not limited to the operations and examples 
described below, which are presented to illustrate the functionality, features, and operation of 
JMSML 

Publish 

[0061] The "Publish" operation is used to create "Publish-Subscribe" message 
producers (or topic publishers) to publish messages to a topic destination. As illustrated in 
Figur 4, the "Publish-Subscribe" messaging model differs slightly from the "Point-to-Point" 
messaging model in that, after being issued by a publisher 90, 92, 94. a single message 96, 
98, 1 00 may be retrieved from an intermediate J MS Object data structure 1 02, 1 04 (referred 
to as a topic in this model), by any number of message consumers 105, 106, 107, 108, 
referred to as subscribers. 
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[0062] The following example shows a simple topic publish operation in accordance 
with one embodiment of the invention: 

<operation Class= "message " Type="Text" 
Name Top i c Pub 1 i she r " 

Factory=" JNDI Name of the Connect ionFactory" 
' Topic= "JNDI -Name of the Topic Destination" 
Body="Some Text" 
>Publish</operation> 

[0063] In this example, a JMS text message containing the string "Some Text" is 
published to a topic destination that is identified by the "Topic" attribute, using the JMS 
connection factory identified by the "Factory" attribute. It should be noted that in the above 
examples for the send and publish operations, the "Body" attribute is used to specify the 
content of the JMS Text message that is sent. In cases where the body of the message is not 
important, this attribute may be ignored since It is not a required attribute of the operation 
element. Inoneembodiment,thedefaultvalueforthemessagebodyofa JMStextmessage 
is a JAVA string of 1024 bytes in size containing the letter "a". 

[0064] Atopic may be published within a JMS transaction using a transacted session, 
as shown in the following example: 

<operation Class="message" Type="Text" 

Name = " My Pub 1 i she r " 

Factory^ " j ms . qa . connect ion . TCFl " 

T6pic=" jms .qa. destination. Tl" 

Transact ionType= " JMS " 

Transaction= "commit" 

Count="10" 

Size="128" 
> Publ i sh< /operat ion> 

[0065] The above operation publishes ten (1 0) text messages of 1 28 bytes each (in 
this instance each with the default text "a" since no other body text is specified) to the topic 
"T1" using the connection factory "TCF1" within a JMS transacted, auto-acknowledged 
session, and commits the transaction. 
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Subscribe 

[0066] The "Subscribe" operation is used to create "Publish/Subscribe" message 
consumers (or topic subscribers, including durable subscriptions) to receive messages from 
a topic destination. An example of how a simple durable subscription with very nriinimal 
attributes may be constructed in JMSML can be shown as follows: 

<operation Class=="message" Type="Text" 
Name="TopicSubscriber" 

Factory=" JNDI Name of the ConnectionFact'ory" 
T6pic="JNDI Name of the Topic Destination" 
- - . purable= "Durable Subscription Name" 
>Subscribe</operation> 

[0067] In the above example, a Topic subscriber named "TopicSubscriber" is created 
for the durable subscription (identified by the "Durable" attribute) to receive JMS text 
messages from the topic destination, which in turn is identified by the "Topic" attribute, using 
the JMS connection factory identified by the "Factory" attribute. 

Unsubscribe 

[0068] The "Unsubscribe operation is used to unsubscribe any previously created 
subscription by a given topic subscriber. An example of an unsubscribe operation in 
accordance with one embodiment of the invention is shown below. 

<operation Class= "message" Type="Text" 

Name=" TopicSubscriber" 
>UnSubscribe</operation> 

[0069] In this example, the current subscription by the "TopicSubscriber" is 
unsubscribed. 
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Miscellaneous JMS Operations Using JMSML 

[0070] The following operations illustrate how JMSML can be used to perform 
miscellaneous JMS operations, in accordance with one embodiment of the invention. 



Recover 

[0071] The "Recover" operation may be used to recover the JMSSession that is 
currently used by the consumers. The process of recovering a JMSSession used by a queue 
sender can be accomplished with the following XML code example: 

<operation Class= "message" Type="Text" 

Name =" Queue Sender " 
>Recover</operation>., 

[0072] A JMSSession used by a queue receiver may be recovered similarly, as shown 
in the example below. 

<operation Class= "message" Type="Text" 

Name = " QueueRec e i ve r " 
>Recover</operation> 

[0073] In the examples shown above, the current session used by "QueueSender*' and 
"QueueReceiver"are recovered respectively. 

Browse 

[0074] The "Browse" operation is used to browse the messages that are currently 

available in a queue destination. The following XML code example creates a simple queue 
browser in accordance with one embodiment of the invention: 

<pperation Class="message" Type="Text" 
' Name="MyBrowser" 

Factory="MyFactory" 

Queue =" MyQueue " 
>Browse</operation> 
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[0075] In the above example, a browser named "MyBrowser" is created to peek into 
the messages residing in the "MyQueue" destination. 

Drain 

[0076] The "Drain" operation is used to empty the messages from a given JMS server 
or JMS destination. In accordance with one embodiment of the invention, a drain may be 
accomplished using the following XML. code examples (which describe draining a JMS 
server, and a JMS destination, respectively): 

Draining a JMS Server 

<operation Class= "message" Type="Text" 

Name= "MyDrainerl " 

JMS S erve r = " My JMS s'e r ve r " 
>Drain</operatign> , 

Draining a JMS Destination 

<operation Class= "message" Type="Text" 

Name="MyDrainer2 " ■ . 

JMSServer= " ErrorQueue " 

>prain< /operat ion> 

Remove 

[0077] JMSML processors create and maintain several types of JMS objects including 
"Senders", "Publishers","SyncQueueReceivers", "AsyncQueue Receivers", 
"SyncTopicSubscribers", "AsyncTopicSubscribers", and "Browsers" in the corresponding 
object pools. In accordance with one embodiment of the invention, when these objects are 
no longer needed, they can be removed from the pool by using the "Remove" operation. The 
"Reniove" operation is used to remove the JMS producers and consumers that are identified 
in the "Type" attribute from the JMSML producer and consumer pools. 
.[0078] The following XML code examples illustrate how a queue sender and a 
synchronous queue receiver, respectively, may be removed from the JMSML producer and 
consumer pool, in accordance with one embodiment of the invention: 
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Removing a Queu Sender from th JMSML Producer Pool 

<operation Class= "message" Type=" Sender" 

Name =" Sender " 
> Remove </ op e rat i on > 

Removing a Synchronous Queue Receiver 

<operation Class="message" .Type="SyncQueueReceiver " 

Name= " SyricQueueRecei ver " 
> Remove < / op e r at i on > 

JMX OPERATIONS 

[0079] Each JMX operation depends mainly on two required "Type" and "Name" 
attributes of the operation element. The "Class" attribute is set to MBean for all the JMX 
operations. All other MBean attributes are specified as plain string name-value pair 
depending on the JMX operation. JMSML processors internally convert these values into 
appropriate JAVA data types required by the JMX API. Depending on the JMX operation. 
JMSML also provides default attribute values for the MBean operations. 
[0080] Table 5 lists the JMSML operations defined for JMX, and which are explained 
with examples in the sections below. 



Add 


- creates a JMS Config MBean 


Change 


' changes the attributes values of a JMS MBean 


List 


- lists the attribute values of a JMS Config/Runtime MBean • 


Remove 


- deletes a JMS Config MBean 


Pause 


' pauses a JMS Runtime Destination 


Resume 


- resumes a paused JMS Runtime Destination 


Start 


- deploys (Target) a JMSServer to WebLogic Server 


Stop 


- undeploys (Untarget) a JMSServer from WebLogic Server 


Migrate 


- migrates the JMS Service betvyeen WebLogic Servers 


Startup 


- starts up a WebLogic Server instance 


Shutdown 


- shuts dovyn a WebLogic Server instance 



Tables 
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Add 

[0081] This operation is used to create a new JMS "Config MBean" which is identified 
by the "Type" with the given attribute values, and will be named using the "Name" attribute 
value. The example below illustrates how a JMSServer with default attribute values may be 
created, in accordance with one embodiment of the present invention. 

<operation Class="mbean" Type=" JMSServer" 

Name = " My JMS e r y e r 1 " 

Targets="MyWebLogicServer" 
> Add < / op e r a t i on > 

[0082] The above operation creates a JMSServer MBean with all the default attribute 
values, and targets it onto the MyWebLogicServer instance. 

[0083] One may also create a JMSServer MBean and simultaneously set the attribute 
values, as shown in the following example: 

<operation Class="mbean" Type=" JMSServer" 
Name = " My JMS e rve r 2 " 

MessagesMaximum= " 10000 " " 
MessagesThresholdHigh="7500" 
Message.sThresholdLow= " 5 0 b " 
BytesMaximum=" 1024000" 
BytesThresholdHigh="7500" 
By t e sThr e shol dLow= " 5 0 0 " 
Ta r get s= "MyWebLogicServer" 
>Add</oper^tion> 

[0084] The operation shown above creates a JMSServer MBean with given attribute 
values, and targets it onto the MyWebLogicServer Instance. 

[0085] In accordance with one eitibodiment of the invention it is also possible to create 
a JMSDestination MBean and simultaneously set the attribute values, as shown in the 
example below: 

<operation Class="mbean" Type= "Queue" 
Name= " MyQueue " 
JMS S e r ve r = " My JMS S e r ve r 1 " 
JND I Name = " MyQue ue i " 
Byte sMaximum= " 1024 " 
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BytesThresholdHigh= " 512 " 
By t e sThr e sho 1 dLow= " 6 4 " 
MessagesMaximum= " 16 " 
MessagesThresholdHigh= " 8 " 
MessagesThresholdLow= " 2 " 
PriorityOverride= " 6 " 
TimeToLi veOverr ide= "7200000" 
Del i veryModeOverride= " Pers i stent " 
StoreEnabled= "default " 
>Add</operation> 

[0086] The above operation creates a queue destination "MyQueue!" with the 
specified attribute values, and adds it to the existing JMSSeryer "MyJMSServerl". 

Chang e 

[0087] The "Change" operation is used to change the attribute values of an existing 
JMS Gonfig MBean. The following examples illustrate the change operations performed on 
a newly created JMS connection factory MBean in accordance with one embodiment of the 
invention: 

<operation Class = "mbean" Type="ConriectiohFactory" 
Name="FCCFl" 

F 1 owCon t r o 1 Enabl ed= " t rue " 
JNDIName="FCCFl" 

FlowMaximum="1000" FlowMinimum=" 100" 
Flowlnterval="300" FlowSteps="30" 
Target s="myserver" 
>Add</operation> 

<operation Class="mbean" Type=" Connect ionFactory" 

Name="FCCFl" 

F 1 owMaxi mum= " 1 0 0 " 
> Change < / op e r a t i on > 

<operation Class= "mbean" Type=" Connect ionFact cry*' 
Name="FCCFl", 
FlowMaximum= " 99 " 

ExpectedException=" I nvalidAttributeValue Except ion" 
>Change</operation> 
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[0088] It should be noted thatthe examples described above show hovy both "Add" and 
"Change" operations can be combined together to achieve specific dynamic management 
scenarios. The "ExpectedException" attribute is used in the second "Change" operation to 
illustrate the handling of negative scenarios by JMSML when used for configuration testing 

List 

[0089] The "List" operation displays all of the attributes of all JMS "Config MBeans" 
and/or all "Runtime MBeans". Such a listing of "Config" and "Runtime MBean" attributes may, 
respectively, be generated by using a JMSML syntax similar to the following example: 

.<operation Class="mbean"Type=" Config" . 

■ Name="All" ' . . 

>List</operation> 

<operation Class="mbean" Type = "Runtime" 
- Name="All" 
■ >List</operation> 

[0090] At times, it nriay be desirable to list statistics for only one specific "Config" or 
"Runtime MBean". Such a listing may be obtained by setting the "Name" tag to the name of 
the desired MBean while performing the "List" operation. This may be performed using syntax 
similar to the following example: 

<operation Class="mbean" Type=" JMSServer" 

N ame = " My JMS S e r ve r " 
>List</operation> 

[0091 ] The above operation will list all configuration attributes of the JMSServer MBean 
"MyJMSServer''. 

<operation Class="rabean'V Type="DestinationRuntime" 

Name =" MyQueue " 
■.>List</operation> . 
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[0092] The above operation lists all the statistics information, such as the current 
message count and pending messages count, of the "MyQueue" destination. 



Remove 

[0093] The "Remove" operation is used to remove the JMS "Config MBeans" identified 
in the "Type" and "Name" attributes from a sen/er instance (for example a WebLogic Server 
instance). Remove may be performed as shown in the following example: 

<operation Class = "mbean" Type='" JMS Server" 

Naine= "MyJMSServer" 
>Remove</ opera tion> 

[0094] This operation removes the instance of the "MyJMSServer" JMSServer MBean. 
Pause 

[0095] The "Pause" operation is used to pause the JMSDestination Runtime MBean 
that is identified by the "Name" attribute and may be performed as shown in the example 
. below: 

<pperation Cl.ass= "mbean" Type =="DestinationRun time" 

Name =" MyQueue " 
>Pause</operation> 

R sum 

[0096] The "Resume" operation is used to resume a previously paused 
JMSDestination Runtime MBean, identified by the "Name" attribute. This operation may be 
performed as follows: 

<operation Class= "mbean" Type="DestinationRuntime" 

Name =" MyQueue " 
>Resume</operation> 
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start 

[0097] The "Start" operation is used to dynamically deploy (target) the JMSServer 
MBean to a given application server instance. This deployment may be accomplished shown 
in the following example. 

<operation Class="mbean" Type="JMSServer Runtime" 

Name-"BE1" 

>Start</operation> . ' . . 

Stop 

[0098] The "Stop" operation is used to dynamically undeploy (untarget) the JMSSen/er 
MBean from a given server (for example a WebLogic.Server) instancie. This operation may 
be performed as follows: 

< operation Class="mbean" Type=" JMSServerRunt ime" 

Name="BEl" ■ ■ ■ 

>Stop</operation> " ■ 

Migrate 

[0099] The "Migrate" operation provides the capability for migration of a JMSService 
between multiple server (for example WebLogic Server) instances within a cluster for 
managed failover processing. For example, a JMSService may be migrated from the current 
source or "preferred" sen/er to a destination server "S2" of the migratable target "MT1 2" using 
the following syntax: 

<:operation Class="mbean" TYpe="MigratableTarget " 

Name="MT12" 

Target Server = "Admin" 

Dest inat ionServerName= " S2 " 

SourceServerUp=" false" 
>Migrate</operation> 

Startup 

[0100] The "Startup" operation is used to start a managed server (for example 
WebLogic Server) instance with the help of a running server manager or node manager 
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("NodeManager") on that machine. In order to execute this operation, the "TargetServer" 
attribute must be specified with the value of the "Admin" server name. For example, a 
managed server instance "S1" could be started using the "NodeManager" running on the 
same machine using the following syntax: 

<operation Class="mbean" Type="Server" 

Name="Sl" 

TargetServer= "Admin" 
>Startup</operation> 

Shutdown 

[0101] The "Shutdown" operation is used to shut down a running managed server 
instance with the help of the "NodeManager" running on that machine. In order to execute this 
operation, the "TargetServer" attribute must be specified with the value of "Admin" server 
name. For example, a managed server instance "SI" can be shut down using the 
"NodeManager" running on the same machine using the following syntax: 

<operation Class="n±)ean" Type=" Server" 

Name="Sl" 
> Shu t down< / op e r a t i on > 

System Operations Provided by JMSML 

[01 02] System operations are support operations that work in conjunction with the JMS 
and JMX operations previously discussed. System operations are performed by first setting 
the Class and Type attributes of the operation to the value "System". 

Sleep . 

[0103] In accordance with one embodiment, JMSML provides the capability for 
directing the system to pause, or sleep, for a preset amount of time. The user can specify the 
quantity of time desired and the unit of time measurement. For example, the "Sleep" operation 
can be performed by first setting the "Class" and "Type" attributes to the value "System", and 
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setting the "Time" and "Unit" attributes to the desired number and unit of time measurement, 
respectively: 



<operation Class=" system" Type = "System" 

Silent = "true" 

Time="5" Unit=" Seconds" 
>Sleep</operation> 

[01 04] I n the example given above, the operation makes the JMSML engine sleep for 
5 seconds. The "Silent" attribute indicates that no output message of any sort is created for 
the execution of this operation. If this attribute is set to "False", then there will be a message 
output indicating the execution of this "Sleep" operation. 

Echo 

[0105] The "Echo" operation directs the system to send a certain text string to 
"standard out". This command may be used in troubleshooting programs. The "Echo" 
operation may be used as shown in the following exannple: 

<operation Class=" system" Type=" System" OutputEnabled="true" 

TimeStampEnabled="true" . 
Body= "Hello World with output enabled true">Echo</operation> 

[0106] The above syntax would send the following string as output (depending on 
current system time): 

16:51:19 ECHO Hello World with output enabled true 

[01 07] This particular functionality is valuable, particularly as applied to problems which 
arise when attempting to troubleshoot a system with a heavy transaction load. The "Echo" 
command provides the ability to isolate specific transmissions and allows for immediate 
location of certain events of interest in the/system log files. 



Attorney Docket No.: BEAS-01351US3 
kfk/beas/1 351 /1 351 us3/1 351 us3.app.wpd 



-33- 



Express Mail No. EV 327 616 845 US 



JMSML EXECUTION METHODS 

[01 08] The JMSML language can be supported in a variety of different environments 
and through a variety of different interfaces, which can be presently summarized as follows: 

1 . JMSML Integrated Development Environment (IDE); 

2. Standalone Java Client; or, 

3. Java Servlet webapp. 

[01 09] The method of parsing a text file so as to generate JMS and JMX commands 
and the organization of the various components which comprise the JMSML method 
previously described may be implemented in a variety of client and server environments. The 
JMSML user may choose to employ the JMSML functionality in whichever embodiment best 
suits his/her personal preferences or business objectives. The particular embodiments 
described hereafter are not intended to be exhaustive. Rather, these examples are given for 
illustrative purposes, and for the purpose of enabling oneof ordinary skill in the art to perforin 
the method described. 

JMSML Markup Language as Part of an Integrated Development Environment (IDE) 

[01 1 0] Traditional JAVA development follows the steps, of creating the source code, 
and then compiling and executing the code on a specific platform. The increasing complexity 
of function and integration of tools over multiple platforms means that tool development cannot 
generally be performed by small groups of developers. Often the only way to produce a fully 
functioning application is to make use of specially-designed application development tools 
in ordelrto build othertools. Today's applications are built using a mixof low-leyel tools such 
as source editors and debuggers, along with high-level builders for creating user interface, 
data access, distribution support, and code generators. The applications which are built in 
such environments are targeted to run in a multiplicity of execution environments, on various 
hardware platforms, supporting many distribution mechanisms and data access mechanisms. 
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Developing such applications usually requires the use of multiple different tools from multiple 
different vendors, each solving a piece of the overall puzzle. 

[0111] The most efficient way for a developer to program is usually to operate within 
an integrated development environment (IDE), in which information provided by each tool 
during program development can be shared with other tools, particularly those being used in 
the same development effort, so as to avoid duplication, and inconsistencies in the interface 
and function operations. JMSML development may involve writing a XML file and then 
tweaking this file baised on output received from other components of the JMSML engine. 
Therefore, in accordance with one embodiment of the invention, the components of the 
JMSML engine can be incorporated into an JMSML-tailored IDE, furtherextending the ease 
of performing JMS and JMX operations. Figure 5 shows a JMSML system that includes an 
Integrated Development Environment in accordance with an embodimentof the invention. The 
IDE itself can be bundled as a JAR file and executed from any Java Virtual Machine (JVM). 
In the embodiment shown in Figure 5, the client 120 includes an Integrated Development 
Environment (IDE) 1 22 that includes a Graphical User Interface (GUI) 124. Among othertools 
and features, the GUI may include a source code editor 126 that allows direct editing of the 
JMSML code, and a design window 1 28 that allows for visual-based program design. The 
IDE works with a JMSML engine 130 located at the client, to create, update, and execute 
JMSML programs 1 34, 1 36. The JMSML programs can perform operations on any of local 
or remote servers 1 38, 1 39. Figure 6 shows the various components used by the IDE. As 
shown in Figure 6, XML formatted JMSML commands maybe introduced into the IDE Source 
Window 144 from a plurality of sources, such as from a pris-existing source file 140, or they 
may alternatively be acquired from an input device, such as a keyboard when the IDE user 
manually inputs such commands 142. In some embodiments the system can additionally 
comprise a design window 146 to give a pictorial representation of the JMSML commands, 
and a JMSML operation tree 148 to give the IDE user a "birds-eye" view of the code as a 
whole. The commands shown in the source window 144 can then be passed to the JMSML 
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engine 150, and after being processed, the results of these commands stored in a verbose 
log 152, an error log 154, or an output log 154. One example of ^uch an IDE comprises a 
multi-sectioned graphical user interface as depicted in Figures 7-14. The key functional 
components of the IDE in this embodiment are the previously mentioned source window 206 
and the design window 258. The IDE user may toggle between these windows by using the 
tabs 214, 216 situated on the bottom left corner of the window. 

[0112] As shown in Figure 7, the source window 206 allows for manual code 
manipulation, and the JMSML operations may be loaded into this window from an existing 
XML file or entered by the user. As JMSML code is entered into the source window, the 
JMSML Operation Tree 202 located in the left hand side section of the IDE is populated after 
the JMJSML engine has made a determination that a valid and properly formatted JMSML 
operation has been created in the source window 206. The JMSML Operation Tree allows a 
"birds-eye" view of the JMSML source code and also enables the IDE user to quickly jump to 
a certain section of code in the source window 206 by simply clicking on the desired JMSML 
entry in the tree 202. The JMSML Integrated Development Environment Project Management 
Tree 200 provides a project-level view of all compilations of JMSML code. For example, a 
user might have multiple XML source files which will ultimately be located on separate 
systems running the JMSML engine. The user may wish to copy a set of JMSML operations 
from one source file to the next. The JMSML Integrated Development Environment Project 
Management Tree 200 allows him/her to toggle between projects, copying from one and 
pasting into another and managing multiple JMSML files as a single project. Additional 
features include tabs to switch from a source view 21 4, to a design view 21 6; and a log output 
window 208 which includes tabs to switch from regular output 210, to error output 212, or 
verbose output 204. 

[0113] Figures 8, 9 and 10 illustrate additional features within the design window 
component of the IDE. In one embodiment ofthe IDE, the design window 258 enables the IDE 
userto generate JMSML commands using a pictorial representation ofthe various elements 
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and commands. Once the design window258 is displayed, the IDE user will select eitherthe 
JMS 252, JMX 254, or Messages 256 toolbars tab, depending on the operation being 
performed. Each of these tabs, once selected, triggers the engine to display a plurality of 
operations available for creation or execution. The IDE user can then complete additional 
steps to accomplish his/her desired operation, such as editing the properties of a JMS object 
shown in the properties window 250, or creating a new topic or destination. As these 
operations' are performed pictoriaily in the design window, the corresponding 
JMSML-compliant code is generated in the source window. After finishing with the design 
window, the IDE user can then toggle back to the source window and fine-tune the 
JMSML-compliant code which now appears in the source window. 
[0114] As described above, each toolbar tab 252, 254, 256 in the design window 258 
offers a plurality of functionalities designed to make creating JMS and JMX operations easier. 
If the IDE user selects the JMX tab 252, the five JMX options depicted in Figure 8 will be 
displayed. The first JMX option labeled "Add CC"259 allows the IDE user to create a JMS 
Connection Consumer. 

[0115] Another JMX option, labeled "Add SSP" 260, allows the IDE user to create a 
Server Session Pool MBean which is of particular use for asynchronous JMS consumers. 
Another JMX option, labeled "Add Dest" 262, allows the user to create a queue or topic 
destination object. 

[01 16] Another JMX option labeled "Add FE" 264, allows the IDE user to create a 
JMSConnectionFactory (front-end) object. This object must be created before a session may 
be established or a message producer or consumer may be created. The user will typically 
selected a queue or topic via a JNDI lookup, and associate this queue ortopic with the newly 
created JMSConnectionFactory (front-end) object. 

[01 1 7] Another JMX option labeled "Add BE" 266 , allows the IDE user to create a 
JMSServer (back-end) object. JMSServer objects serve as containers for JMS destinations 
such as queues and topics. A JMSServer container must be created before the user attempts 
to create either type of destination object. 
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[01 1 8] The IDE user may also select the JMS tab 254 and this action would trigger the 
IDE to display several JMS options, shown in Figure 9. 

[0119] One JMS option, labeled "Send" 328, will create a "Sender" type message 
producer using the specified JMSConnectionFactory object and then proceed to send a 
message to a certain queue destination object. 

[0120] Another JMS option, labeled "Receive" 330, will create a "Receiver" type 
message consumer using the specified JMSConnectionFactory object and then proceed to 

retrieve a message from a certain queue destination object. 

[0121] Another JMS option, labeled "Browse" 332, allows a userto viewthe contents 
of the queue destination object. 

[0122] Another JMS option, labeled "Publish" 334, will create a "Publisher" type 
message producer using the specified JMSConnectionFactory object and then proceed to 
publish a message to a certain topic destination object. 

[0123] Another JMS option, labeled "Subscribe" 336 will create a "Subscriber" type 
message consumer using the specified JMSConnectionFactory object and then proceed to 
retrieve a message from a certain topic destination object. 

[0124] In accordance with some embodiments, the IDE user may wish to explicitly 
create a certain type of JMS message. Figure 10 illustrates an interface in accordance with 
an embodiment of the invention that allows them to do so. The IDE user can click on the 
"messages" tab 366 which triggers the IDE to display the "messages" operations toolbar 
window 378. The user is then presented with 5 buttons which may be used to either create a 
text me$sage 368, a byte message 370, an object message 372, a mapping message 374 
or a content message 376. Once the user has clicked the appropriate button, he must then 
enter appropriate values in the property window 360. For example, in Figure 9, the IDE 
shown therein shows that the user is in the process of creating a text message containing the 
string "Test message for order queue" as shown both in the property window 360 and the 
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corresponding visualization of the new message 380 displayed in the messages operations 
window 378. 

[0125] Figure 11 shows the IDE in accordance with another embodiment of the 
invention, wherein the user has directed that verbose logging be displayed during the 
execution of the JMSML source code shown in the source window 41 6. After the execution, 
the user can view the these verbose output in the IDE by by clicking the "Verbose" tab 41 0. 
The "Verboise" option will typically be used in this embodiment of the invention when 
debugging code. 

[0126] Figure 12 further illustrates the type of output which is displayed in the 
"Verbose" window 432 in an embodiment of the invention. The window 432 displays server 
output afterthe user has directed it to list the contents of the "Warehouse" MBean. Of interest 
in this figure is the server output snippet 438 which illustrates the recitation of initialization 
parameters back to the user which is of use when debugging JMSML source code. 
[01 27] Figure 1 3 shows the server output displayed when the IDE user clicks on the 
"Output" tab 446 and directs the interface to display server output. It will be noted that the 
appropriate "Output" messages will always be generated for each JMSML operation when 
any source code shown in the source window 456 is executed, while "Verbose" 450 
messages can be turned on or off atthe discretion of the executing user. In the embodiment 
of the invention shown in Figure 1 1 ;the server is informing the IDE user that the state of the 
source code in the source window 456 has not been changed . by displaying the "Dirty Flag" 
'\s "False" icon 444. 

[0128] Figure 14 illustrates an example of content displayed in the "Output" window 
462 indicating successful JMX List operation that is a listing of the previously mentioned 
"Warehouse" MBean's attributes, following execution of certain JMSML source code shown 
in the source window 474. 
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JMSML Markup Language Method as Implemented in a Stand-alone JAVA Client 
[0129] In one embodiment of the invention, a standard JAVA client coupled with the 
JMSML system components is provided, along with a JMSML-complianttext file, preferably 
written in the Extensible Markup Language (XML). Figure 15 shows a JMSML system that 
includes a command-iine interface in accordance with an embodiment of the invention. The 
client 502 operates on a computer or similar processing device 500. A cpmnrian-line interface 
504 is used to access the JMSML engine 506, and to make use of XML files 508. JMS and 
JMX commands 510 are generated and communicated to servers, including servers 512 
located on the same processing device, and/or servers 514, 516 located on remote 
processing devices. In accordance with one embodiment, the XML file is supplied to the 
JMSML engine, through the JAVA language, by invoking a JAVA method from the command 
line of the client machine. In this embodiment, the user instantiates an instance of the JMSML 
method from the command line and supplies default values for various system options at the 
time the method is invoked. This information is passed to the JMSML engine via the preset 
flags shown in Table 6: 



-url: 


The URL of the application server (e.g. myappserver://localhost:7001) 


-protocol: 




-host: 


Hostname 


-port: 


Port 


-username 


User to connect as for the purpose of executing JMS/JMX operations 


-password 


Password associated with this user 


-jmsmldir 


JMSML directory 


-filename 


XML filename 


-wisretease 


Application server release number 


-verbose 


True/False (default=False) 


-console 


True/False (default=False) 



Table 6 



[0130] For example, in the context of a WebLogie Server environment, the JMSML 
engine may properly be invoked in conjunction with WebLogie Server using the following 
command-line syntax: 
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machinename : > java com, bea . jmsml , controller . JMSCl lent \ 

-protocol t3 \ 
-host localhost \ 
-port 7001 \ 
-username jmsml admin \ 
-password jmsml admin \ 
-jmsmldir 

/export/home/ jmsmladmin/bea/weblogic700/samples/ 
'server/conf ig/examples \ - . . 

-filename QueueSend.xml 

-verbose true 

[0131] In this embodiment, the JMSML engine, once instantiated, runs entirely within 
the confines of the stand-alone JAVA client. The JMS and JMX commands are executed on 
the specified application server, the various output files are written to the specified destination, 
directory, and controi is then passed back to the user. 

[01 32] Figure 16 shows a flowchart of the operation of a JMSML system that includes 
a command-line interface in accordance with an embodimehtof the invention. In step 530, 
the user opens a command-line interface at the client. The user then, in step 532, enters 
commands to invoke a Java method. In step 534, the corresponding command (in XML 
format) is passed to the JMS engine. In step 536, the JMSML engine generates the 
appropriate JMS/JMX commands and communicates them to the relevant server. Results 
may be optionally generated, and in step 538 stored in an optional results file. 
[0133] It will be evident that, while some of the examples are shown as operating in a 
WebLogic Server environment, the JMSML language, and particularly the client interface 
described above, can be used in other environments, and with other types of application 
server. Also, the client and the server may reside on the same physical machine, or on 
different machines', depending on the particular implementation. 
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JMSML Markup Language Method Implemented In a Web Interface 

[01 34] In accordance with another embodiment, the JMSML method may be executed 
or accessed by a web interface. In this embodiment, the JMSML engine executes on a remote 
server as a servlet, and the user interacts with the engine using a web browser or web 
application which resides on his/her client machine. The advantage of this embodiment is that 
JMS and JMX operations may be performed by a user accessing the web application from 
any remote location, including via a wide are network (WAN) or the Internet, provided that 
he/she possesses the proper security credentials. 

[0135] Figure 1 7 shows a JMSML system that includes a web interface in accordance 
with an embodiment of the invention. The web interface embodiment provides much more 
functionality than the stand-alone JAVA client embodiment. As shown in Figure 17, the 
system 568 includes a JMSML servlet 552 and a JMSML servlet engine 554. The JMSML 
servlet accepts commands from a Web Interface 561, 563 (for example a Web Browser) 
operating at a client 560, 562. The client may be located on a wide area network, or may 
communicate with the system via the Internet 566. The Web Interface accepts commands 
from the user via a graphical and/or text-based interface, and communicates those commands 
to the JMSML servlet. The JMSML engine generates corresponding JMS/JMS commands 
570 and communicates them to the appropriate server. The server may be local to the 
system, or may be remote (572, 574). 

[0136] Figure 18 shows a flowchart of the operation of a JMSML system that includes 
a Web interface in accordance with an embodiment of the invention. In step 580, the user 
enters commands into the Web Interface (the Web browser) at the client. In step 582, the 
browser communicates the entered codes to the JMSML servlet and JMSML servlet engine. 
In step 584, the JMSML servlet/engine formulates the corresponding JMS/JMX commands, 
and in step 586 the JMS/JMX commands are sent to the appropriate servers. 
[01 37] Figure 1 9 shows a screenshdt of a Web interface 600 in accordance with an 
embodiment of the invention. In some embodiments the user can interact with the JMSML 
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engine via a Graphical User Interface (GUI). "TextArea" objects are supplied forthe user to 
enter the required protocol, host name and port information, or alternatively, the user may 
simply select frequently used values for these attributes from a pull-down list. The user may 
then either identify the XML file to be passed to the engine, or manually enter the JMSML- 
compliant code into a text box. If he/she chooses to use a pre-created XML file and is 
unaware of the file's exact location, then the user may browse their local filesystem by clicking 
the "Browse" button which, in turn, will trigger another GUI and provide a representation of his 
local filesystem. The specific functionality of this second GUI will vary depending on the 
particular implementation which operating system is running on the client machine. After 
locating the desired XML file and clicking on it, the details of the filename will be automatically 
filled into the "TextArea" object forthe "XML File:" prompt. Upon clicking the button labelled 
"Open above XML file", the code contained in the XML file will be loaded into the code 
window. 

[01 38] Once the user is satisfied that the code appearing in the code window should 
be executed . they can elect to use the "Verbose" option or specify, for example, a WebLogic 
Server Release Version by clicking the checkbox located adjacent to the desired option. The 
"Execute" button may now be clicked and, upon completion, the "verbose" and "standard 
output" results will be displayed in a window labeled as such. Should errors arise, the user 
needs only to make the required correction in the code window and re-execute his/her 
changes. 

JMSML USE-CASE ANALYSIS WITH WORKING EXAMPLE 

[01 39] This section describes one example of how to use JMSML as a testing tool to 
test BEA WebLogic JMS and JMX. 

[0140] Once testing scenarios are identified, they can be easily translated into JMSML 
operations, grouped as testing scenarios using <scenario> with Verify attribute set to "false" 
and saved as a JMSML program. This test program can be executed using one of the 
JMSML execution models. After the successful execution, an output file is created with the 
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samenameastheinputJMSML program and with an .out extension. It is verified manually 
for correctness and then saved as a benchmark file (again in the same name as the input 
JMSML program but with a .bmk extension), 

[01411 Later, whenever the same JMSML program is executed, with the "Verify" 
attribute of the <scenario> element set to "true", JMSML treats that input JMSML program as 
a test, and the output file is automatically compared with the corresponding benchmark file for 
the test verification. If the benchmark and the outputfile matches, then the test is declared as 
PASSED. OthenA/ise, it will be declared as FAILED. 

[0142] Example. Testthe dynamic creation, management, and monitoringof the JMS 
administered objects and the message send, receive features of JMS. 
[01 43] Testing Scenario: Create a JMSServer named "Warehouse" with all the default 
attribute values and deploy it on a WebLogic Server instance named "examplesServer". 
Create a queue destination named "orderqueue" with all the attribute values explicitly defined , 
add it to the JMSServer named "Warehouse", bind it into JNDI as "jms.queue.order", 
send/receive messages to this queue, and at the end delete both the queue "orderqueue" 
destination and the "Warehouse" JMSServer. 

[0144] The following JMSTEST.XML sample is the JMSML representation of the 
Testing Scenario defined above. 

<?xml version-"! . 0" encoding="UTF-8 " ?> 
'<!DOCTYPE jmsml PUBLIC "-//BEA Systems Inc//DTD JMSML Version 1,0 
JMSML/ /EN" " jmsml. dtd"> • ■ ^ . 

<jmsml> 

< scenario Name =" Dynamic Queue creation" Verify=" false" > 
<purpose> 

To test the dynamic creation of queue 
</purpose> 

<expectedresult > 

JMS queue destination should be successfully created with the specified 
attributes. In order to verify this, two additional, operations are 
performed as shown below. 
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1. Take the statistics information of the JMSServer "Warehouse", before 
anci after the creation of the queue destination, to see if the newly 
created queue has been added to the current destination count of the 
JMSServer . "Warehouse" . 

2. A sender and receiver will be created to send and receive a text 
message to and from the newly created "orderqueue" . 

If the above two operations are successful, the test is declared as 
PASSED. Otherwise the test ' is declared as FAILED. 

</ expect edresult>' 

<operation Class="mbean" 
Typ e = " JMS S e r ve r " 
, Name = "Warehouse" 
Targets="examplesServer" 

> Add < / op e r a t i on > 

<operation Class="mbean" . . 

Type=" JMSServer" 
Name= "Warehouse" 

>List</operation> 

.<operatioh Class= "mbean" . . 
Typ e = " JMS S e r ve r Runt i me " 
Name= "Warehouse" • . 

, >Ijist</operation> 

< operation CI as s= "mbean" Type = "Queue" 
Name = " orde rqueue " 
JMSServer=" Warehouse" - 
JND I Name= " j ms . queue . order " 
BytesMaximum=" 1024000" 
BytesThresholdHigh=" 1000000" 
- BytesThresholdLow="4 0 96" , 
MessagesMaximum=" 100000" 
MessagesThresholdHigh= "96060 " - 
Me ssagesThresholdLow=" 1,000" 
PriorityOverr ide= " 6 " 
TimeToLiveOverride=" 7200000" 
DeliveryModeOverride= " Persistent " 

StoreEnabled= "default" . . 

> Add< / opera t i on > 

<operation Class= "mbean" Type="Queue" 
Name =." or de r queue " 

>List</operatipn> 

-coperation Class= "mbean" Type=" JMS Server Runtime" 
Name= "Warehouse " 
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>Ijist</operation> 

<operation Class="mbean" Type="DestinationRuntime" 
Name = " orderqueue " 

>Lis t < / operat ion> 

<operation Class="message" Type="Text" 
Name= " sender " 

Factory="weblogic .examples . jms .QueueConnectionFactory" 
Queue= "jms . queue . order" 
Body="Test message to order queue" 
>Send< /operat ion> 

<operation Class="mbean" Type="DestinationRuntime" 
Name="orderqueue" ^ 
>Li St < /operat ion> 

<operation class = "message".. Type="Text " 
Mode =" Synchronous " 
Name= " receiver " 

Factory="weblogic . examples .. jms .QueueConnectionFactory" 
Que!ue= " j ms . queue . order " 
.. >Receive</operation> 

<operation Class="mbean" Type= "DestinationRuntime" 
Name="orderqueue" . 
>Li St < /operat ion> 

<operation CI ass = "mbean " Type =" Queue" 
Name= " or de rqueue " 

>Remove< /operat ion> 

<operation Class= "mbean" Type="JM.SServer Run time" 
Name= "Warehouse " 

>Li St < /operat ion> 

<operation Class= "mbean" Type=" JMS Server" 
Name= "Warehouse" 

>Remove< /operat ion> 

</scenario> 

</jmsml> 

Listing 1 
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[0145] Once a JMSML program is written, it can be run against a WebLogic Server 
instance. Currently, JMSML provides three different ways to execute a program. See the 
following section on "JMSML Execution Models" to get detailed information on these different 
ways. In order to continue with this example, a standalone command-line execution method 
is shown below: 

java com. bea . jmsml . controller .JMSClient \ 

-protocol t3 \ 

-host localhost \ 

-port 7001 \ . ' ■ 

-username weblogic \ 
-password weblogic \ . 

-filename jmstest.xml 

[0146] The command line above assumes the following about the execution 
environment: 

An inistance of WebLogic Server named "examjDiesServer*' is running on "localhost" 
and is listening on the port "7001" with the "t3" protocol enabled. 

WebLogic security is set up such that a user named "weblogic" with a password of 
"weblogic" is configured with permissions for creating and accessing JMS server 
components. 

A valid JMS connection factory is deployed on the "examplesServer" and is bound to 
JNDI as "webiogic.examples.jms.QueueConnectionFactory", 

The test program shown in Listing 3 "jmstest.xml" is saved in the current directory along 
with the "jmsml.dtd" file. 

[0147] After the successful execution of the above command, the following message 
will be printed out to the stdout: 

*** jmstest processed *** \n*** Please see / jmstest . out for the results *** 
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[01 48] At this time, an output file named "jmstest.out" will exist in the current directory, 
containing all the operations execution results, as shown in the "jmstest.out" below. 



JMSServer 
Name 
Targets [0] 
BytesMaximum 
BytesThresholdHigh 
By t e s Thr e s ho 1 dLo w 
Me s sage s^laxi mum 
MessagesThresholdHigh 
MessagesThresholdLow 



Warehouse was added to server : 
= Warehouse 



example sServer 1- 



example sServer 

-1 

-1 

-1 

-1 

-1. 

-I 



Name 


= Warehouse 


Sess ionPool sCur rent Count 


= 0 ' 


Sess ionPool sHighCount 


= 0 . 


SessionPoolsTotalCount 


= 0 ■ 


pes tinat ions Current Count 


= 0 


DestihationsHighCount 


= 0 


DestinationsTotalCount ' 


= 0. ' . 


Mess ages Cur rent Count ■ . 


= 0 ; 


Me s sage sHi ghCount 


=^ .0 


Mes sage s PendingCount 


= d' . 


MessagesReceivedCount 


= 0 


By t e s Current Count 


■ = 0 


By t e s H i ghCount 


.= 0 


BytesPendingCount 


= 0 


By t e sRece i vedCount 


= 0 



Queue Destination 
Name, 
JNDIName 
JMSServer 
StoreEnabled 
Type . ■ 
BytesMaximum 
BytesThresholdHigh 
BytesThresholdLow 
Mess age sMaximum 
MessagesThresholdHigh 
MessagesThresholdLow 
PriorityOverride 
TimeToLiveOverride 
Del iveryModeOverr ide 



•order queue was added to JMSServer 
= ' order queue 

jms . queue . order 
= Warehouse 
= default 

Queue 
= 1024000 
= 1000000 
= 4096 
■= 100000 
= 90000 
= 1000 
= 6 

= ■ 7200000 
Persistent 



Warehouse 



Name 

Sess ionPool sCur rent Count 
SessionPoolsHighCpunt 
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SessionPoolsTotalCount 


= 0 


DestinationsCurrent Count 


= 1 


Dest inat ionsHighCount 


= 1 


DestinationsTotal Count 


= 1 




- n 


Me s sage sHi ghCount 


= 0 


Me s s age s PendingCount 


= 0 


MessagesReceivedCount 


= 0 


By t e sCur r ent Count 


= 0 


BytesHighCount 


= 0 


BytesPendingCpunt 


= 0 


jBytesReceivedCount 


= 0 


Name 


= . order queue 


Consumers Cur rent Count 


= 0 


Con s ume r sH i ghCoun t 


= 0 


Con s ume r s To t a 1 Coun t 


= 0 


rltrfc>J3Cty co'^Ui- -L til 1 u v_.wLiliL 


— D 


MessagesHighCount 


= Q . 


MessagesPendingCount 


= 0 . 


MessagesReceivedCount 


■= 0 . 


BytesCurrent Count 


= 0 


BytesHighCount 


= 0 • 


Bytes PendingCount 


= 0 


BytesReceivedCount 


= 0 


Name 


. = order queue 


Consumer sCurrent Count 


= o" 


ConsumersHighCount 


= 0 


Consumer sTotalCount 


= 0 ■• 


ric s o age s^-ur rent L-ount- 


= 1 


MessagesHighCount 


== 1 . - 


MessagesPendingCount 


= . 0 


MessagesReceivedCount . 


== 1 


By t e s Cur rent Count 


= 27 


BytesHighCount 


= 27 


By t e s Pendi ngCoun t 


= 0 


By t e sRe ce i vedCount 


*- 27 


©receiveMessage ( ) : Message 


Received [0] : Te 


Name 


= . orderqueue 


Consumer sCurrent Count 


= 1 


ConsumersHighCount 


=■ 1 


Consumer sTotalCount 


= 1- 


MessagesCurrent Count 


=. 0 


MessagesHighCount 


= 1 


' MessagesPendingCount 


= 0 


MessagesReceivedCount 


= 1 


By t e s Current Count 


= 0 


BytesHighCount 


= 27. 
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Byte s PendingCount 
By t e s Re c e i ve dCoun t 



- 0 
= 27 



Queue ; orderqueue was removed from JMSServer : Warehouse 1 



Name 


Warehouse 


Bess ionPool sCurrent Count- 


= 0 


SessionPoolsHighCount 


- 0 


SessionPoolsTotal Coun t 


= 0 


Dest inat ionsCurrent Count 


= 1 


DestinationsHighCount 


= 1 


Dest inat ipnsTotalCount 


= 1 


MessagesCurrent Count 


= ■ 0 


Me s s age sHighCount 


= 1 


MessagesPendingCount 


= 0 


Me s sage sRece i vedCount 


= 1 


BytesCur rent Count 


= 0 


BytesHighCount 


27 


By t e s PendingCount 


= . 0. 


BytesReceivedCount 


^ 27 



JMSServer .- Warehouse was removed from server -: examplesServer 1 



Listing 2 

[01 49] Once the above output is manually verified for correctness, you can easily make 
this a valid reusable WebLogic JMS test case by doing two things: 

1 . Rename the "jmstest.out" file to "jmstest.bmk" 

2. Edit the "jmstest.xml" file by changing the Verify attribute value to "true" in the 
<scenario> element. 

[0150] The next time the same command line is executed, JMSML then treats the 
"jmstest.xml" as a test case and prints out the test pass/fail result to the stdout. As can be 
seen, without writing a Java program, we have quickly written a complete test case for BEA 
WebLogic JMS and JMX features. 
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jmsml.dtd File 

[0151] The following is an example of a JMSML Document Type Definition file. 



<?xmi version- ' 1 1 0 ' encodings ' UTF- 8 ' ?> 

<! ENTITY % message. types "Text | Bytes | Ob j act ] XML | Map" > 

<!ENTITY % message "Message"> 

< ["entity % system " System" > 

<!ENTITY % all "Ari"> . . 

<1 ENTITY % jms. header 

"JMSMessagelDj / 

JMSCorrelationlDl 

JMSDestinationI . 

JMSReplyTol ■ 

JMSTimestamp I 

JMS Expiration I 

JMSPriorityl 

JMSDeliveryMode| . 

JMSType I - . . • . 

JMSRedelivered".> " = 

<i ENTITY % runtime.mbeans • . . \ ' 

"ServerRuntime I 

Connect ionFactoryRunti me I 

Connect ionRunt ime 1 • 

JMSServerRuntime I 

QueueRunti'me I , ' . 

TopicRuntime I 

DestinatipnRuntime I 

SessionPoolRuntime I 

SessionRuntime I 

Connect ionConsumerRunt ime I 

Consumer Run time | 

ProducerRuntime I 

StoreRutime| . . 

FileStoreRuntime I 
JDBCStoreRuntime |. 

TemplateRuntime I 
DestinationKeyRuntime" > 

<! ENTITY. % conf ig.mbeans 

"Server | ■ ^ 

MigratableTarget I 
Target | 

ConnectionFactory I 
JMSServerl 
Queue I 
Topic I . 
Destination! 
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SessionPool | 
Connect ionConsumer I 
Filestore I 
JDBCStorej 
Template I 
DestinationKey" > 

<! ENTITY % jms. clients 
"Sender I 

Publisher I 

SyncQueueReceiver | . 
AsyneQueueReceiver | 
SyncTopicSubscriber | 
AsyncTopicSubscriber I 
Browser" > 

<!ENTITY % notification. objects 

"Nbtif icationFilter |Notif icationListener"> 



<! ENTITY % mode 

< I ENTITY % transactiontype 

<! ENTITY % transaction 

<! ENTITY % ackmode 
"NoAckj 

Auto 1 " 

CI lent Yes I 

Client No I 
Multicast "> 

<!E1S|TITY % txpolicy 

<! ENTITY. % deliverymode 

<! ENTITY % timeunit 

<! ELEMENT jmsml 

< ! ELEMENT scenario 



" Synchronous | Asynchronous" > 
"JMS I User "> 
"commit | rollback" > 



" TX_ONE I TX_PREVI OUS | TX_ALL " > 
"Persistent I Non-Persistent"> 
"Millis I Seconds (Minutes | Hours "> 
( scenario* I operation+ ) > 

(purpose?, expectedresult? , operation+)> 



<!ATTLIST scenario Name 

Verify 
Persistence 

SortedVerif ication (true | false) 

<! ELEMENT purpose (# PCDATA) > . 



CDATA # REQUIRED 

(true.| false) #REQUIRED 

. (true I false) #IMPLIED 

#IMPLIED> 



< I ELEMENT expectedresult 



(# PCDATA) > 
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< ! ELEMENT operation 



{# PCDATA) > 



<!ATTLISt operation • 
AsyncQueueReceiver 
Ack 

AckAf terMessages 
AsyncTopicSubscriber 
Body . 

BytesMaximum 
BytesThresholdHigh 
By t e sThr e sho 1 dLow 
By t e s Pagi ngEnab 1 ed 
Class 



Condition 
Count 

Connect ionFactory 
Conrie c t i onConsume r 
Conf ig 

Configured ■ - 

Connect i onFac t oryRunt ime 
Connect iofiConsuTnerRiintime 
ClientID 
Cluster 
Destination 
DestinationServerUp 
DeliveryMode 
, De 1 i ve ry ModeOve r r i de 
DestinationKey 
Dest inat ionServerName 
DestinationKeys 
Dest inat ionRunt ime 
Def aultRedeliveryDelay 
Durable 

ErrorDest inat ion 

Expe c t edExcep t i on 

FileStoreRuntime 

Filestore 

Filter 

FlowMaximum 

FlowMinimum 

Flowlnterval 

FlowSteps 

FlowControlEnabled 
Factory 

JDBCStoreRuntime 
JDBCStore 
JMSCorrelationiD 
JMSServerRunt ime 



CDATA # IMPLIED 

(%ackmode;) - #IMPLIED . 
CDATA # IMPLIED 

CDATA #IMPLIED 
CDATA ttlMPLIED 
CDATA. # IMPLIED 

CDATA # IMPLIED 

CDATA ,#IMPLIED 
CDATA #IMPLIED 

(message | 

mbean [ 

system) #REQUIRED 
CDATA . ' . # IMPLIED 
CDATA # IMPLIED 

CDATA # IMPLIED 

CDATA #IMPLIED 
CDATA ■ • #IMPLIED 
CDATA # IMPLIED 

CDATA #IMPLIED 
CDATA # IMPLIED 

CDATA # IMPLIED 

CDATA # IMPLIED 

CDATA #IMPLIED 
(true I false) #IMPLIED 
(%deliverymode; ) #IMPLIED 
(%deliver-ymode; ) #IMPLIED 



CDATA 


#IMPLIED 


CDATA 


#IMPLIED 


CDATA 


# IMPLIED 


CDATA 


ttlMPLIED 


CDATA 


#IMPLIED 


CDATA 


#IMPLIEP 


CDATA 


^IMPLIED 


CDATA 


#IMPLIED 


CDATA 


#IMPLIED 


CDATA 


ttlMPLIED 


CDATA 


#IMPLIED 


CDATA 


#IMPLIED 


CDATA 


#IMPLIED 


CDATA 


ttlMPLIED 


CDATA . 


#IMPLIED 


CDATA 


'#IMPLIED 


CDATA' 


ttlMPLIED 


CDATA 


^IMPLIED 


CDATA 


#IMPLIED 


CDATA 


■ #IMPLIED 


CDATA 


#IMPLIED 
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JMSServer 
JNDIName 
JMSMessagelD 
JMSReplyTo 
JMSDestinatioh 
JMSDe 1 i veryMode 
JMSExpiration 
JMSTimestamp 
JMSRedelivered 
JMSType 
JMSPriority 
MessagesMaximum 
.MessagesThresholdHigh 
MessagesThresholdLow 
MessagesPagingEnabled". . 
MigratableTarget 
MigrateDestination • 
Mode 
Name 

Not ificationFi Iter 

Notif icationListener . ■ 

PagingStore 

Persistent 

Priority 

Priori tyOverride 

Print 

PrintMesssage 
Print Per formanee 
Queue 

QueueRunt ime 

Rede liyeryDelayOver ride 

RedeliveryLimit 

Silent 

Shut downMe s s age 

Size 

SleepBef oreAck 
SleepAf terAck 
SleepBef orePublish 
SleepAf terPublish 
SleepBeforeReceive ' 
SleepAf terReceive 
SleepBef oreSend 
SleepAf terSend 
Selector 
Server • ' 
-SessionPool . . 
Store 

StoreEnabled 

Severity 

Subsystem 



CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
CDATA 
, CDATA 
( %mode ) 
CDATA 
CDATA 
CDATA 
CDATA 

(true 1 false) 

CDATA 

CDATA 

{%jms .header 

(true I false) 
CDATA 
CDATA 
■ CDATA 
CDATA 
CDATA 

(true I false) 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA 

CDATA . 



#IMPLIED 

#IMPLIED 

#IMPLIED 

#IMPLIED 

#IMPLIED 

#IMPLIEP 

#IMPLIED 

#IMPLIED , 

# IMPLIED 

# IMPLIED 

# IMPLIED 

#IMPLIEP' 

#IMPLIED 

#IMPLIED 

#IMPLIED 

#IMPLIED 

#iMPLIED 

ttlMPLIED 

#IMPLIED 

#IMPLIED 

ttlMPLIED , 

# IMPLIED 

#implied" 

#IMPLIED 

#implied 

;) #IMPLIED 

#IMPLIED 

#IMPLIED 

#IMPLIED 

#IMPLIED 

ttlMPLIED 

#IMPLIED 

#IMPLIED 

^IMPLIED 

# IMPLIED 

#IMPLIED 

^IMPLIED 

#IMPLIEP 

#IMPLIED 

ttlMPLIED 

#IMPLIED 

#IMPLIED 

# IMPLIED 

#IMPLIED 

#IMPLIED 

# IMPLIED 

#IMPLIED 

#IMPLIED 

#IMPLIED 

#IMPLIED 
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Sender 

SyncQueueReceiver 
SyncTopicSubscriber 
Se s s i onPoo 1 Runt ime 
SourceSeryerUp 
Sort Attributes 
Type 



Target 

Target Server 

Targets 

Topic 

Topic Runt ime • 
Template 
-TimeToDeliver 
TimeToDeliverOverride 
Time 

Transacted 

Transact ionType 

Transact ionPol icy 

Transa.ction 

Unit 

Used 

Wait 



CDATA 
CDATA 
CDATA 
CDATA 



#IMPLIED 
#IMPLIED 
ttlMPLIED 
#IMPLIED 



(true I false) #IMPLIED 

(true I false) #IMPLIED 

(%conf ig.mbeans ; | 

%runtime.mbeans; I 

%jms . clients ; | 

%notif ication . obj ects ; | 

%message; |%system; I 

%message . types ; | 

%all;) #REQUIRED 

CDATA #IMPLIED 

CDATA" ■ . # IMPLIED 

CDATA # IMPLIED 

CDATA #IMPL.IED 

CDATA # IMPLIED • 

CDATA #IMPLIEP 

CDATA # IMPLIED 

CDATA - -#IMPLIED 

CDATA #IMPLIED 

(true 1 false) #IMPLIED 

(transactiontype ; } #IMPLIED 

(%txpolicy;) #IMPLIED 

(%transaction; ) ttlMPLIED 

(%timeunit;) #IMPLIED 

CDATA #IMPLIED 

CDATA #IMPLIED> 



Listing 3 



JMSML OPERATION ATTRIBUTE TABLES QUICK REFERENCE 

[0152] In this section, all tlie JMS operation attributes are listed in table format for 

quick reference. 
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Common Attributes of the "message class" operations (Send, Receive, Publish and 
Subscribe) include: 



Attribute 
Name 


Description 


Required? 


Valid Values 


Default 


Name 


Name of the message 
producer/consumer (and 
session) 


Yes 


A valid Java String 




Type 


Type of the message to send 


Yes 


Text|Object|Bytes|Stre 
am|Map|XIVIL 


'Text" 


Factory 


JNDI Name of the JMS 
Connection factory 


Yes 


JNDI Name 





Table? 



Common Attributes of the message Produce Operations '{Send and Publish) include: 



Attribute 


Description 


Required? 


Valid Values 


Default 


Queue 


JNDI Name of the JMS Queue 
Destination 


Yes 


JNDI Name 




Ack 


JMSSession acknowledgement 
Mode 


No 


"Autol 

ClientYesI 

ClientNol 

No Acknowledge" 


"Auto" 


Transacted 


JMSSession transacted option 


No 


"true|false" 


"false" 


TransactionType 


Type of transaction 


No 


"JMSIUser 




Transaction 


Transaction result . 


No 


"commit|rollback" 




Body 


Text Message content 


No 


"A valid Java String" 


A string of "a" of 
length 1024 


Size 


Size of the default content of 
Text Message 


No 


"A valid Integer" 


"1024" 


Count 


Number of messages to send 


No 


"A Valid Integer" 


"1" 


Priority 


JMS Priority of the message 


No 


"A valid value 


"producer's default 




being send 




between 1 to 9" 


priority" 


TimeToLive 


Expiration time of the message 
being send in milliseconds 


No 


"A valid Integer value" 

or "All" 


Infinite 


JMSCorrelationID 


JMS Message header field 


No 


"A valid String" 




JMSType 


JMS Message header field 


No , 


"A valid String" 




JMSReplyTo 


JMS Message header field 


No 


"A valid JMS 
destination JNDI name" 





Table 8 
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Attributes specific to message Send Operation include: 



Attribute 


Description 


Required? 


Valid Values 


Default 


Queue 


JNDI Name of the JMS Queue 
Destination 


Yes 


JNDI Name 




SleepBeforeSend 


Time in seconds, to sleep before 
sending the message 


No 


"A valid Integer" 




SleepAfterSend 


Time in seconds to sleep after 
sending the message 


No 


"A valid Integer" 





Table 9 

Attributes specific to message Publish Operation include: 



Attribute 


Description 


Required? 


' Valid Values 


Default 


Topic 


JNDI Name of the JMS Topic 
Destination . 


Yes 


JNDI Name 


Mil 


SleepBeforePublis 

h 


Time in seconds, to sleep before 
publishing message 


No 


"A valid integer" 


un 


SleepAfterPublish 


Time in seconds to sleep after 
publishing the message 


No 


"A valid Integer" 


■III 



Table 10 



[01 53] The following is the XML representation of the Send and Publish operations, 
with all the possible attribute/values. The optional attributes are shown within the comments 
tags (<—>). 

<6peration 
Class= "message" 
Type="Text" 

Name="A Valid Java St:ring" 

Factory=" JNDI Name of the JMS Connection Factory" 

Queue |Topic ="JNDI Name of the- JMS Queue/Topic Destination" 

<-- Ack="Auto| ClientYes I ClientNo|NoAcknowledge" --> 

Transacted="true I f alse" • 
<-- TransactionType="JMS|User" --> . 

Transaction=" commit I rollback" --> . 
<-- Body="A valid Java String" -->. 
<-- Siz.e="A valid Integer value" --> - 
<-- Count = "A valid Int:eger value" --> 
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<-- Priority="A value between 1 to 9" --> 
<-- TimeTpLive="A valid Integer value" --> 

<-- JMSCorrelationID="A valid value per JMS' Specification" --> 
<-- JMSType-"As per JMS Specification for JMSHeader fields" --> 
<-- JMSReplyTo="As per JMS Spec- for JMSHeader fields" --> 
SleepBef ore { Send) Publish} ="A valid integer value" --> 
SleepAfter{Send| Publish} ="A valid integer value" --> 
<-- ExpectedException="A valid Java Exception class Name" 
>Send| Publish</operation> 

Attributes of a message Consumer {Receive and Subscribe) Operations include: 



Attribute 


Description 


Required? 


Valid Values 


Default 

Value 


Mode 


Receiving mode of ttie consumer 


No 


"SynchprnousI 
Asynchronous" 


''Synchronous" 


Wait . 


How long to wait in case of 


No 


"A valid integer" will be 


(blocking 




Synchronous receive 




treaded in seconds" or . 
"No" fpr receive with 
noWait API which will 
return immediately 


receive) 


Ack 


.JMSSps^Inn arknnwIpHaempnt 
Mode 


No 


"Auto| 
ClientYesI 
CliehtNol 
NoAcknowledge" 


"Auto" 


AckAfterMessage 
s 


Indicates the consumer to 
acknowledge after the every 
"number" of receives 


No 


"A valid Integer" 


T 


Transacted 


JMSSession transacted option 


No 


"true|false" 


"false" 


TransactionType 


Type of transaction 


No 


"JMSIUser 




Transaction 


Transaction resu}t 


No 


"commit(rollback" 




TransactionPolicy 


indicates the consumer to 
execute the transaction 
operation as per the policy 


No ► 


"TX_ONE| 

TX_PREVIOUS| 

TX_ALL'' 


"TX_ONE" 


Count 


Indicates the number of 
messages to be received by a 
synchronous receiver 


No 


"A Valid Integer" or "AH" 


"1" 


Print 


Indicates the receiver to Print the 
JMS Header properties 


No 


"A valid JMS message 
Header field name" 




Selector 


Message selector used for 
receive 


No 


A valid selector 
expression as per JMS 
Specification 





Table 11 
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Attributes specific to message Receive Operation include: 



Attribute 


Description 


Required? 


Valid Values 


Default 
. Value 


Queue 


JNPI Name of the JMS Queue 

Destination 


Yes 


JNDI Name 




SleepBeforeRecei 
ve 


Time in seconds, to sleep before 
receiving the message 


No 


"A valid Integer" 




SleepAfterReceive 


Time in seconds, to sleep before 
receiving the message 


No 


"A valid Integer;' 





Table 12 



Attributes specific to message Subscribe Operation include: 



Attribute. 


Description 


Required? 


Valid Values 


Default 
Value 


Topic 


JNDI Name of the JMS Topic 
Destination 


Yes 


■JNDI Name 




Durable 


Enables the creation of Durable 
subscription by this name 


No 


A valid Java String 




SleepBeforeSubs 

cribe 


Tinrie in seconds, to sleep before 

subscribing the message 


No 


"A valid Integer" 


un 


SleepAfterSubscr 
ibe 


Time in seconds, to sleep before 
subscribing the message 


No 


"A valid Integer" 





Table 13 

[0154] The following is the XML representation of the Receive and Subscribe 
operations, with all the possible attribute/values. The optional attributes are shovyn within the 
comments tags (<- -->). 

<operation 
Class= "message" 
Type="Text" 

K[ame="A Valid Java String'? 

-59- 

Attorney Docket No.: BEAS-01 351 US3 

kfk/beas/1 351 /1 351 us3/1 351 us3.app.wpd Express Mail No. EV 327 61 6 845 US 



Factory^" JNDI Name of the JMS Connection Factory" 

Queue I Topic="JNDI Name. of the JMS Queue/Topic Destination" 

<-- Ack="Auto|ClientYes|Client:No|NoAcknowledge" 

<-- Transacted="true|false" 

<-- TransactionType=" JMS I User" --> 

<-- Transaction^" commit I rollback" --> 

<-- Count="A valid Integer value" --> 

<-- Print="A valid JMSHeader field name" --> 

<-- Selector="A valid message selector expression" --> 

<-r SleepBef ore {Receive 1 Subscribe} = "A valid integer value" --> 

<-- SleepAfter{Receive I Subscribe}="A valid integer value" --> 

<-- ExpectedException="A valid Java -Exception class Name" --> 
Durable="A valid Java String" --> 

>Receive I Subscribe</operation> 

[01 55] The present invention may be conveniently iniplemented using a conventional 
general purpose or a specialized digital computeror microprocessor programmed according 
to the teachings of the present disclosure. Appropriate software coding can readily be 
prepared by skilled programmers based on the teachings of the present disclosure, as will be 
apparent to those skilled in the software art. 

[0156] In some embodiments, the present invention includes a computer program 
product which is a storage medium (media) having instructions stored thereon/in which can 
be used to program a computer to perform any of the processes of the present invention. The 
storage medium can include, but is not limited to, any type of disk including floppy disks, 
optical discs, DVD, CD-ROMs, microdrive, and magneto-optical disks, ROMs, RAMs, 
EPROMs, EEPlROMs, DRAMs, VRAMs, flash memory devices, magnetic or optical cards, 
nanosystems (including molecular memory ICs), or any type of media or device suitable for 
storing instructions and/or data. 

[01 57] The foregoing description of the present invention has been provided for the 
purposes of illustration and description. It is not intended to be exhaustive or to limit the 
invention to the precise forms disclosed. Many modifications and variations will be apparent 
to the practitioner skilled in theart. Particularly, it will be evident that additional JMS markup 
language (JMSML) operations can be developed in accordance with the specifications 
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described herein. The JMSML methodology and language may also be used with application 
servers in addition to the WebLogic Server, It will also be evident that other types of 
command-line environment, interfaces, and Integrated Design Environment (IDE) can be 
devised to allow a software developer to design, test, and implement JMSML-based 
applications. The embodiments were chosen and described in order to best explain the 
principles of the invention and its practical application, thereby enabling others skilled in the 
art to understand the invention for various embodiments and with various modifications that 
are suited to the particular use contemplated. It is intended that the scope of the invention be 
defined by the follovying claims and their equivalence. 
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